home *** CD-ROM | disk | FTP | other *** search
/ AGA Toolkit '97 / The AGA Toolkit '97.iso / miscellaneous / help / dos / dosman / man / requestchoice < prev    next >
Encoding:
Text File  |  1996-09-07  |  2.3 KB  |  68 lines
  1.  
  2.  
  3.             REQUESTCHOICE (3.x only, located in C:)
  4.  
  5.        NAME
  6.             Requestchoice - Adds a decision requestor to an 
  7.         AmigaDOS script file or AREXX script.
  8.  
  9.        SYNOPSIS
  10.             Requestchoice titlebox bodytext buttontext(s) 
  11.         [PUBSCREEN screenname]
  12.  
  13.        DESCRIPTION
  14.             When the requestor window opens and lets the user 
  15.         chose from one or more buttons. When a button is chosen, 
  16.         the number of that button is returned.
  17.  
  18.        KEYWORDS
  19.  
  20.         titletext
  21.             The text you want in the title bar of the window. It 
  22.         is a good idea to have this title bar mention where the 
  23.         window was launched from so that the user won't get 
  24.         confused. You must always include titletext. If you don't 
  25.         want to have text in your titlebar, then use a blank text 
  26.         string (""). 
  27.  
  28.         bodytext
  29.             This is the main body text of the window. (for 
  30.         example "Do you wish to continue?"). This string is also 
  31.         required.
  32.  
  33.         buttontext(s)
  34.             This assigns the words to the button choices. You 
  35.         must have atleast one button. Extra buttons may be added 
  36.         by just tacking on extra text screens. Every button is 
  37.         assigned a number, when a button is chosen b the user, 
  38.         the command returns this number to the console. If there 
  39.         are text for many buttons, they will appear from left to 
  40.         right. The button on the leftmost is number 1, the next 
  41.         is number 2, and so on. The only exception is the last 
  42.         button entered which is assigned the number of zero. This 
  43.         is reserved for the "Cancel", "No", or "Quit" optons.
  44.  
  45.         [PUBSCREEN screenname]
  46.             This lets you place your requestor on any public 
  47.         screen by adding this keyword with the name of the 
  48.         screen.
  49.  
  50.  
  51.         EXAMPLES
  52.  
  53.             1. Print the number in the shell window the user 
  54.         selects from the requestor:
  55.  
  56.   SET Number 'REQUESTCHOICE " " "Pick your number" 1 2 3 4 5 0'
  57.   ECHO "You chose the number $Number"
  58.  
  59.  
  60.             2. Ask the user to continue or quit:
  61.  
  62.     SET Continue 'REQUESTCHOICE Script "Continue???" Yes No'
  63.        IF VAL $Continue EQ 0
  64.        ECHO "You're outta here!"
  65.        QUIT
  66.        ENDIF
  67.     ECHO "Next command??"
  68.